home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 5 / Amiga Plus Sonderheft 1996 #5.iso / programme / imagedesk304 / autocat / instructions.doc < prev    next >
Text File  |  1996-03-13  |  16KB  |  327 lines
  1. ***********************************************************************************
  2. *                                                                                 *
  3. *                                     A U T O C A T                               *
  4. *                                                                                 *
  5. *                 AREXX-Enhancer for Reinhard Haslbeck's ImageDesk                *
  6. *                                                                                 *
  7. *                            Automatized Browser for Catalogs                     *
  8. *                                                                                 *
  9. *                           INSTALLATION- AND OPERATIONMANUAL                     *
  10. *                                                                                 *
  11. *                                    by Ulrich Röcher                             *
  12. *                                                                                 *
  13. ***********************************************************************************
  14.  
  15.  
  16. TABLE OF CONTENTS
  17.  
  18. 1. Introduction of AUTOCAT
  19. 2. Requirements for using AUTOCAT
  20. 3. How it works
  21. 4. Installation of an ImageDesk-AUTOCAT-System
  22. 5. Functions and Features
  23. 6. Legality
  24. 7. The Author
  25.  
  26.  
  27. PREFACE
  28. Due to an error in earlier versions of AUTOCAT it was not possible to start
  29. AUTOCAT from the tooltypes or by command-line parameter. This has been fixed in
  30. this archive's version of AUTOCAT. Both should work now.
  31. This version of AUTOCAT has been adopted for ImageDesk 3.0. If you want to use
  32. it on an ImageDesk version prior to 3.0, you have to delete or command out the line
  33. SETSPREFS THUMBSORT FALSE
  34. in the first part of AUTOCAT.
  35.  
  36.  
  37. 1. INTRODUCTION OF AUTOCAT
  38.  
  39. Reinhard Haslbeck has written with his program 'ImageDesk' a real good piece of
  40. software for the Amiga. ImageDesk catalogizes and organizes electronical saved
  41. pictures in a nice and handy way. ImageDesk reads most of the common formats of
  42. graphic files, displays them at a good speed. It produces thumbnails (small copies
  43. of the original pictures) to give an overview and this way eases the selection
  44. of requestet pictures. It runs on AA, on different types of graphics boards and
  45. on Frank Mariak's/Thomas Sontowski's Cybergraphics-RTG-Software. ImageDesk offers
  46. an AREXX-Port with full functionality.
  47.  
  48. On the other hand the selection and moving through collections of catalogs sucks;
  49. every catalog has to be loaded manually with its full filename. The size of the
  50. catalogs has to match the size of the screen, if you do not want to select the
  51. requested range of thumbnails yourself. 
  52.  
  53. AUTOCAT was written to improve this. It automatizes the handling of the catalogs
  54. completely. You can move forward or backward through any number of catalogs with
  55. any number of thumbnails no matter how many thumbnails your screen can display.
  56. The catalogs can be organized like the filing system on your harddisk; i.e. you
  57. can generate thematical organized sub-directories, which you can select or leave
  58. as you want. All these movements are done by single mouse-clicks - just the way
  59. you click a thumbnail for watching the picture behind it. It is not needed to
  60. provide file-names. AUTOCAT sorts all catalogs of a sub-directory before dis-
  61. playing them. This way you can influence the display-order of your catalogs.
  62. Since this sorting is done dynamical at every program-start, new catalogs can
  63. easily be added to existing catalog-directories. AUTOCAT recognizes and works
  64. according to the settings of your system (screenmode, viewer, thumbnail-size ..)
  65. and changes itself only those parameters it needs for its own operation.
  66.  
  67.  
  68.  
  69. 2. REQUIREMENTS FOR USING AUTOCAT
  70.  
  71. Well, just the same as for ImageDesk: At least 8-Bit display modes on your system,
  72. which means AA or a graphics-board. According to the manual of ImageDesk at least
  73. 4 MB of contiguous memory for the generation of the thumbnails.
  74.  
  75. To be able to use AUTOCAT, you will need the *** registered *** version of Image-
  76. Desk. AUTOCAT does NOT run on the unregistered version. You need at least version
  77. 1.6 of ImageDesk or Version 2.02 and up. Attention! AUTOCAT does not run on the
  78. Versions 2.0 or 2.01 of ImageDesk! On your machine there must exist the file
  79. "rexxsupport.library" in the directory "libs:" (Belongs to Amiga Operating System).
  80.  
  81.  
  82.  
  83. 3. HOW IT WORKS
  84.  
  85. Easy! Reinhard Haslbeck has luckily given ImageDesk lots of formats for graphic
  86. files. That way one of that formats can be used as a command-format instead of
  87. a display format, so that clicking on a thumbnail with a command-format does not
  88. result in displaying a picture but executing an AREXX-Action. E. g.: If BMP was
  89. choosen as the command-format, then clicking on a BMP-thumbnail will not display
  90. the picture but execute a command like "display next thumbnail page" or "display
  91. thumbnails of catalogs in sub-directory". You will have to accept the small dis-
  92. advantage, that you can no longer use all graphic formats at one time, but I
  93. regard this as acceptable since you can choose the command-format yourself. The
  94. default command-format of AUTOCAT is BMP, Important to know is that the AREXX-
  95. program isn't executed the whole time AUTOCAT is running, but only when actions
  96. are performed. This way a lot of processing time is saved. Important values are
  97. temporarily saved by AUTOCAT in RAM.
  98.  
  99.  
  100.  
  101. 4. INSTALLATION OF AN IMAGEDESK-AUTOCAT-SYSTEM
  102.  
  103. In the beginning a sub-directory-structure should be created for organizing your
  104. catalogs, e.g. this way:
  105.  
  106.                  Picture-catalogs
  107.            /        /     |        \
  108.        nature    house vacancies  persones
  109.      /    |      /   \            /  |   \
  110. flowers animals dream real   anybody |    scenes
  111.                                   friends
  112.  
  113. This structure can have any number of directories and be as deep as you want it
  114. to be. It is possible to create catalogs, where normal thumbnails are mixed with
  115. thumbnails leading to a different sub-directory. It is not necessary to create the
  116. whole subdirectory-structure at once, more catalogs can be added even on running
  117. AUTOCAT-system just as you need them.
  118.  
  119. It is recommended to start generating the catalogs with the deepest sub-direc-
  120. tories; just let ImageDesk create its catalogfiles quite as normal in a size
  121. making sense to you into the subdirectories you made above.
  122.  
  123. ********************************************************************************
  124. ATTENTION! YOU HAVE TO MAKE SURE, THAT IN THOSE SUB-DIRECTORIES ARE ONLY (!)
  125. CATALOG-FILES. ANY OTHER FILES (E.G. .INFO-FILES) WILL LEAD TO ERROR-MESSAGES
  126. WHEN RUNNING THE SYSTEM!
  127.  
  128. AN AUTOCAT-SYSTEM MAY ONLY HAVE THUMBNAILS OF THE SAME SIZE! (IT IS POSSIBLE TO
  129. CREATE MORE THAN ONE SYSTEM ON THE SAME DISK)
  130. ********************************************************************************
  131.  
  132. If you want to create the catalogs for the above-mentioned sub-directory 'nature',
  133. you will have to do a little bit more of work, because the catalog-file will
  134. have to have the hints to the two sub-directories.
  135.  
  136. Do as follows: Just select from the two picture-collections typical representa-
  137. tives and change their formats to the wanted command-format. I do presume here
  138. for easier explanation that this is BMP; just go on reading if you want to know
  139. how to create another command-format. For changing the picture formats, you
  140. can use e.g. AdPro, but you will also find appropriate programs in PD-collections.
  141. Those pics changed to BMP *** MUST *** have exactly the name of the sub-directo-
  142. ry they hint to (Regard capital letters!). At last you create a catalog-file
  143. from this two pictures. This catalog file has to be in the directory "nature".
  144. The BMP-pictures can afterwards be deleted; they are no longer needed.
  145.  
  146. It is no problem to put further catalog-files in the sub-directory nature, whose
  147. thumbnails represent in the normal way other pictures, e.g. which show other
  148. parts of nature. Since the catalog files are automatically sorted displayed,
  149. the position and the order of the thumbnails on the screen can be controlled.
  150.  
  151. As you have done with the sub-directory 'nature', you will have to do with all
  152. other sub-directories in your system.
  153.  
  154. There is only one exception of this rule: When creating the catalogs for the
  155. root-directory 'Picture-catalogs', there names *** HAVE TO BE *** 'Head.cat',
  156. 'Head.cat.1', 'Head.cat.2' and so on. There number is theoretically unlimited
  157. (think about the sorting time), but AUTOCAT won't accept other names. The
  158. creation of the 'Head.cat'-files has to take place the same way like explained
  159. above.
  160.  
  161. When this has been done, you will have to do the following to finish the
  162. installation:
  163.  
  164. - You have to copy the 5 'Command.cat.#'-files from the AUTOCAT-archive to
  165.   the directory where the Head.cat-files are placed. 
  166.  
  167. - If you wish an automatic load of the main picture catalog at every start
  168.   of ImageDesk, you have to write the line 'REXX=:ImageDesk\Rexx\AUTOCAT1.IDesk'
  169.   in ImageDesk's tooltypes, i.e. AUTOCAT is started by executing of the program
  170.   'AUTOCAT1.IDesk'.
  171.  
  172.  
  173. = You have to do the following changes within the AUTOCAT1.IDesk file yourself:
  174.   (Please do it on a copy of AUTOCAT)
  175.   (The lines mentioned can easily be found in the code; they are at the beginning
  176.   just below the header)
  177.  
  178. - In the line beginning with 'CDIR="work2:Kataloge/"'.... you *** MUST *** insert
  179.   in the part within the quotation marks the path of your catalog root-directory.
  180.   (This is the directory where you have copied the file 'Command.cat') Do not
  181.   forget the slash '/' at the end of the path!
  182.  
  183. - In the line beginning with 'CTYP="BMP"' you have to set the desired command-type,
  184.   so if you want a different command-type then BMP, write it down here. If you
  185.   change this, please regard the notes further down in the instructions. If you
  186.   accept the BMP-command-type, let this line unchanged.
  187.  
  188. When you have checked this, all values are set and your ImageDesk-AUTOCAT-System
  189. should work.
  190.  
  191.  
  192. If you like a different command-type then BMP, you should do the following:
  193.  
  194. - Set the CTYP line as described above. The system will accept the following
  195.   values: IFF, GIF, JPG, PCX, BMP, PCD, PNM, TGA. These signs have to be written
  196.   *** exactly *** like shown, so regard the writing of the capital letters!
  197.  
  198. - Sorry, but this is less convenient: You will have to create new files
  199.   'Command.cat.#'. 'Command.cat' are standard ImageDesk catalog-file with three
  200.   entries 'Zurück' (German for beginners: 'Back'), 'Hoch' ('Up'), 'Weiter' (Next).
  201.   The Command.cat files have to be different in their thumbnail-size:
  202.   Command.cat.6 for 60 x 60 pixel-size, Command.cat.8 for 80 x 80 and so on.
  203.   You vill have to create new thumbnails; they will have to have the new
  204.   command-type. Watch the size of the thumbnail-setting on your system!
  205.   For creating the thumbnails, create three graphic-files with
  206.   the intended symbols, convert them to the desired command-type and create a
  207.   new catalog-file. The graphic files have to be named 'Zurück', 'Hoch' and
  208.   'Weiter'. When making the catalog, be careful that the names are written cor-
  209.   rectly and that the order is the same then in the original command-file!
  210.   When finished, you can delete the original graphic-files, which are needed no
  211.   longer.
  212.  
  213. If you do not like the german-named switches 'Zurück', 'Hoch' and 'Weiter', you
  214. should do the following:
  215.  
  216. - Create a new 'Command.cat' file like described above and name the thumbnails
  217.   as you like to do. When describing their function, I will presume, that you
  218.   have done this and named them 'Back', 'Up' and 'Next'.
  219.  
  220. - You have to edit the file 'AUTOCAT2.IDesk' using a standard text-editor.
  221.   You have to change the lines
  222.   'when iname="Weiter" then do'
  223.   'when iname="Zurück" then do'
  224.   'when iname="Hoch" then do'
  225.   Exchange the words in quotation marks with your values. It is very important,
  226.   that they are written the same way (watch capital letters) like they are writ-
  227.   ten in the Command.cat-file you created. Please do not change anything else
  228.   in the 'AUTOCAT2.IDesk' and use a copy of the file for changing the values!
  229.  
  230. How to install more than one AUTOCAT-System on the same Disk:
  231.  
  232. One AUTOCAT-System only allows you to use Thumbnails of the same size. If you do
  233. have Thumbnails of different sizes, you will have to create different systems
  234. like described above with different Head.cat directories. You have to create
  235. more than one AUTOCAT1.IDesk-file, because each one must point to its own Head.cat
  236. directory. You do not have to do further changes in AUTOCAT1.IDesk or to change
  237. AUTOCAT2.IDesk. You can of course not have a mixed use of both systems!
  238.  
  239.  
  240.  
  241. 5. FUNCTIONS AND FEATURES
  242.  
  243. After Installation the system AUTOCAT is started from ImageDesk by calling the
  244. Function 'Project/Execute Arexx' and executing the file 'AUTOCAT1.IDesk'. If
  245. you set up your system correctly, the header-thumbnails of your catalogs will be
  246. displayed.
  247.  
  248. Like said above, this can be automatized by writing a line
  249. 'REXX=:ImageDesk\Rexx\AUTOCAT1.IDesk' into the tool-types of ImageDesk. This
  250. should be considered especially when creating a picture-CD!
  251.  
  252.  
  253. A running AUTOCAT has five functions:
  254.  
  255. - Click on any thumbnail: The picture will be displayed, if the thumbnail does
  256.   not point to another sub-directory.
  257.  
  258. - Click on a thumbnail representing a sub-directory: AUTOCAT goes to this sub-
  259.   directory, clears the screen and displays the first thumbnails of the first
  260.   catalog in alphabetical order. It loads as many thumbnails as will fit on the
  261.   screen.
  262.  
  263. - Click on an 'Up'-Thumbnail: (In the original version of the Command.cat file
  264.   this is a triangle with its top showing up): AUTOCAT changes to the parent-
  265.   directory, clears the screen and displays the first thumbnails of the first
  266.   catalog in alphabetical order. It loads as many thumbnails as will fit on the
  267.   screen. When you have reached the root-directory of your catalogs, only
  268.   the 'Head.cat'-files are loaded. The 'Up'-Thumbnail is displayed on the first
  269.   or second place on screen; if it does not come up, you are in the root-direc-
  270.   tory of your catalogs.
  271.  
  272. - Click on a 'Next'-Thumbnail: (triangle showing right in the original 'Command.
  273.   cat'-file) AUTOCAT clears actual screen and displays next thumbnails from your
  274.   catalogs until the screen has been filled. The 'Next'-Thumbnail is always
  275.   displayed buttom right on the screen; if not, there are no more thumbnails to
  276.   display.
  277.  
  278. - Click on a 'Back'-Thumbnail: (triangle showing left) AUTOCAT clears the screen,
  279.   and displays the preceeding screens again. The 'Back'-Thumbnail is always shown
  280.   top left on the screen; if not, you reached the beginning of your catalog-files.
  281.  
  282. AUTOCAT uses a dynamical display, i.e. the catalogs can be changed, deleted or
  283. new ones can be added. When changing to the sub-directory the next time, the
  284. actual version will be loaded. Because the catalogs are sorted alphabetical,
  285. their name can be used to set the approximate position where the thumbnails are
  286. displayed.
  287.  
  288.  
  289.  
  290. 6. LEGALITY
  291.  
  292. AUTOCAT is Freeware. Every user can do with it what he likes to do. The Author
  293. does not expect a gratification - just think anything nice about me! No - this
  294. is not 'Thinkware' :-))
  295.  
  296. AUTOCAT may be distributed via the Aminet, the Fish- and other PD-CDs or any
  297. mail-boxes. Reinhard Haslbeck may distribute the program together with the
  298. registered version of ImageDesk.
  299.  
  300. The Author is not responsable for any losses, damages or any other disadvantages
  301. coming from using AUTOCAT. Note that you are using it completely at your own
  302. risk!
  303.  
  304.  
  305.  
  306. 7. THE AUTHOR
  307.  
  308. If you want to contact me, write to:
  309.  
  310. Ulrich Röcher
  311. Am Tretenberg 6
  312. 57080 Siegen
  313. Germany
  314. roecher@fts.uni-siegen.de
  315.  
  316.  
  317. If anybody wants to know more about ImageDesk, write to Reinhard Haslbeck.
  318. This is his adress:
  319.  
  320. Reinhard Haslbeck
  321. Spirknerstr. 7
  322. 84137 Vilsbiburg
  323. Germany
  324. haslbeck@informatik.tu-muenchen.de
  325. haslbeck@leo.org
  326.  
  327.